Inside Macintosh: Telephony /

Chapter 1 - Introduction to Telephony on the Macintosh / Telephone Manager Initialization Reference

Telephone Manager Initialization Functions / Configuring a Telephone Tool Through a Custom Interface

TELSetupSetup

Provides the telephone tool with the information needed to setup the controls (such as radio buttons and checkboxes) in the custom tool-settings dialog box.

pascal void TELSetupSetup (
                     short procID,
                     Ptr theConfig,
                     short count, 
                     DialogPtr theDialog,
                     long *magicCookie);

procID

The tool ID for the telephone tool being configured.

theConfig

A pointer to the configuration field in the telephone record for the telephone tool being configured.

count

The number of the first item in the dialog item list that you appended to your custom tool settings dialog box.

theDialog

A pointer to the dialog box in which configuration is taking place.

magicCookie

A pointer to a reserved area of memory used by the telephone tool to pass relevant dialog items and configuration settings.

DESCRIPTION

The tool ID is assigned for a telephone tool through the TELGetProcID function. The dialog item list is stored in a reserved area of memory specified by the magicCookie pointer assigned through the TELSetupPreflight function. You can determine the number of items in the dialog item list by using the CountDITL function described in Inside Macintosh: Macintosh Toolbox Essentials.